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5. ADMINISTRATIVE INFORMATION 
A. Part Introduction 


This portion is a reference guide for system administrators who are using or establishing a graphics(1) 
facility on the UNIX operating system. It contains information about directory structure, installation, 
makefiles, hardware requirements, and miscellaneous facilities of the graphics package. 


B. Graphics Structure 


Figure 5.1 contains a graphical representation of the directory structure of graphics. In this part, the shell 
variable SRC will represent the parent node for graphics source and is usually set /usr/sre/cmd. 


The graphics command resides in /usr/bin. All other graphics executables are located in /usr/bin/graf,; 
the /usr/lib/graf directory contains text for whatis documentation and editor scripts forttoc. 


The source for graphics resides below the $SRC/graf directory which is broken into the following 
subdirectories: 


e include - Contains the following header files: debug.h, errpr.h, gsl.h, gpl.h, setopt.h, and util.h. 


GLIB.D STAT.D | oev.0 | Toc.D GUTIL.D WHATIS.D 
HP7220.D TEK4000.D 


Fig. 5.1 —Directory Structure of Graphics Program 
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e src - Contains source code partitioned into subdirectories by subsystem. Each subdirectory contains its 
own makefile (or Install file for whatis.d). 


e glib.d - Contains source used to build graphical subroutine library, $SRC/graf/lib/glib.a. 
e stat.d - Contains source for numerical manipulation and plotting routines. 

e dev.d - Contains source code for device filters partitioned into subdirectories. 

e lolib and uplib - Contains source used to create device independent libraries. 

e hp72220.d - Contains source for hpd (a Hewlett-Packard plotter display function). 


e tek4000.d - Contains source for ged (the graphical editor), td (a Tektronix display function), and 
other Tektronix-dependent routines. 


e gutil.d - Contains source for utility programs. 

e toc.d - Contains source for table of contents drawing routines. 

e whatis.d - Contains NROFF files and the installation routine for on-line documentation. 
e lib - Contains glib.a which has commonly used graphical subroutines. 


UNIX System User’s Manual entries for graphics reside in /usr/man and consist of the following files: 
graphics.1, gutil.1, stat.1, gdev.1, toc.1, ged.1, and gps.5. 


C. Installing Graphics 
Usage 


The following procedures are used to install graphics. To build the entire graphics package, the superuser 
would execute the following: 


/usr/sre/:mkemd graf 
To build a particular graphics subsystem, shell variable ARGS are used: 
ARGS=subsystem /usr/sr¢e/:mkemd graf 
A subsystem is either glib, stat, dev, toc, gutil, or whatis. The glib subsystem must exist before other 
subsystems can be built. Write permission in /usr/bin and /usr/lib is needed, and the following libraries are 
assumed to exist: 
/lib/libe.a - Standard C library used by all subsystems. 
/\ib/libm.a - Math library used by all subsystems. 
/asr/lib/macros/mmn - Memorandum macros for nroff used by the whatis subsystem. 
/usr/lib/macros/mmt - Memorandum macros for troff used by the whatis subsystem. 
The complete build process takes approximately 2 hours of system time. If the build must be stopped, it is 


a good idea to restart from the beginning. Upon completion, the following things will be created and owned by 
bin. 
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/usr/lib/graf - A directory for data and editor scripts. 
/usr/bin/graf - A directory for executables. 
/usr/bin/graphies - Command entry point for graphics. 

The makefiles use executable shell programs eco and cea. The eco program is used to compile C program 
source and install load modules in /usr/bin/graf. The cca program compiles C programs and loads object code 
into archive files. 

The whatis.d file contains source files for whatis and the executable command install. 


install command-name 


calls nroff to produce whatis documentation for command-name in /usr/lib/graf. To install the entire 
whatis subsystem, the :mkemd is used as previously described. 


Makefile Parameters 
The makefilesuse various macro parameters, some of which can be specified on the command line to redirect 

outputs or inputs. Parameters specified in higher level makefiles are passed to lower levels. The following is 
a list of specifiable parameters for makefiles followed by their default values in parentheses and an explanation 
of their usage: 

e $SRC/graf/graf.mk 

e BIN (/usr/bin) - installation directory for the graphics command. 

e BIN (/usr/bin/graf) - installation directory for other graphic commands. 

e SRC (/usr/sre/emd) - parent directory for source code. 

e $SRC/graf/src/Makefile 

e BIN1 (/usr/bin) - installation directory for the graphics command. 

e BIN2 (/usr/bin/graf) - installation directory for other graphic commands. 

e LIB (/usr/lib/graf) - installation directory for whatis documentation. 

e $SRC/graf/sre/stat.d/Makefile 

e BIN (../../bin) - installation directory for executable commands. 

e $SRC/graf/srce/toc.d/Makefile 

e BIN (../../bin) - installation directory for executable commands. 

e $SRC/graf/sre/dev.d/Makefile 

e BIN (../../bin) - installation directory for executable commands. 


e $SRC/ graf/sre/dev.d/hp7220.d/Makefile 


e BIN (../../../bin) - installation directory for executable commands. 
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e $SRC/gratf/sre/dev.d/tek4000.d/ Makefile 
e BIN (../../../bin) - installation directory for executable commands. 


e $SRC/graf/sre/gutil.d/Makefile 


e BIN (../../bin) - installation directory for executable commands. 


The following example will make a new version of the graphical editor, ged, installing it in /al/pmt/dp/bin 
(assuming that necessary libraries were previously built): 


ed $SRC/graf/sre/dev.d/tek4000.d 
make BIN=/al/pmt/dp/bin ged 


D. Hewlett-Packard Plotter 


The graphics display function, hpd, uses the model 7221A Graphics Plotter manufactured by Hewlett- 
Packard Company. The HP plotter can be connected to the computer in series with a terminal via a dedicated 
or dial-up line. This arrangement allows the plotter to intercept plotting instructions while passing other data 
to the terminal unaltered and thus providing for normal terminal operation. Plotter switch settings should 
match those of the terminal. The plotter operating manual contains a more complete discussion. 


E. Tektronix Terminal 


The graphics display function, td, and the graphical editor, ged, both use Tektronix Series 4010 storage 
tubes. Below is a list of device considerations necessary for graphics operation. 


Entry 

When a Tektronix 4010 series terminal is connected to a UNIX operating system via a dedicated 4800 or 9600 
baud line, /etc/inittab should reference speed table entry 6 (the table entry may vary locally) of getty. Speed 
table entry 6 is designed specifically for the Tektronix 4014 and, among other things, sets a form-feed delay so 
that the screen may be cleared without losing information and clears the screen before prompting for a login. 
The stty(1), inittab(5), and getty(8) programs should be referenced for additional information. 
Strap Options 


The standard strap options as listed below should be used (see the reference manual for the Tektronix 4014): 


LF effect - LF causes line-feed only. 
CR effect - CR causes carriage return only. 
DEL implies loy - DEL key is interpreted as low-order y value. 
Graphics Input terminators - None. 
Enhanced Graphics Module . 
The Enhanced Graphics Module (EGM) for Tektronix terminals is required for graphics. The EGM provides 


different line styles (solid, dotted, dot-dashed, dashed, and long-dashed), right and left margin cursor location, 
and 12-bit cursor addressing (4096 by 4096 screen points). 
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F. Miscellaneous Information 
Announcements 


The graphics command provides a means of printing out announcements to users. To set up an announce- 
ment facility, a readable text file, announce, is created that contains the announcements. Also in 
/usr/bin/graphics, the shell variable GRAF is redefined to be the directory pathname of the file announce. 


Uselog 


The graphics command also provides a means of monitoring its use by listing users in a file. To set up a 
usage logging facility: 


e Create a writable file named .uselog (in the same directory as announce if announcements are being 
used). 


e Redefine the shell variable GRAF within /usr/bin/graphies to specify the directory location. 


Each time a user executes graphics, an entry of the login name, terminal number, and system date are recorded 
in .uselog. 


Restricted Environments 


Restricted environments can be used to limit user access to the system, (sh(1)). A restricted environment 
for graphics can be set up by creating directories /rbin and /usr/rbin and populating them with restricted ver- 
sions of commands from /bin and /usr/bin so that the environment cannot be compromised. In particular, com- 
mands ed, mv, rm, and sh require restricted interface programs which do not allow users to move or remove 
files that begin with a dot. 


To create a restricted environment for graphics, a restricted ged command in /usr/rbin is created as fol- 
lows: 


exec /usr/bin/graf/ged —R 


Restricted logins for users or a community login with a working directory (reached through .profile) should 
be established for each user. A restricted login specifies /bin/rsh as the terminal interface program and is cre- 
ated by adding /bin/rsh to the end of the /etc/passwd file entry for that login. The graphics —r command 
is called from .profile. 


Execution of the graphics —r command changes $PATH to look for commands in /rbin and /usr/rbin be- 
fore /bin and /usr/bin and executes a restricted shell. The —R option is appended to the ged command so that 
the escape from ged to the UNIX operating system (! command) will also use a restricted shell. 
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